🤓 Content for release: 13.5#1233
Draft
IEvangelist wants to merge 84 commits into
Draft
Conversation
…1181) * docs: document timestamp search qualifier for telemetry filtering Documents the new 'timestamp' search qualifier added in microsoft/aspire#17816. Users can now filter traces and structured logs by date/time using ISO 8601 strings with comparison operators (>, >=, <, <=) in the dashboard filter bar. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Move timestamp qualifier docs to shared CLI references Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> * Fix severity casing in timestamp search example Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: James Newton-King <james@newtonking.com> * Apply suggestion from @JamesNK * Apply suggestion from @JamesNK * docs: clarify date-only timestamp search values Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> * Apply suggestion from @JamesNK * Apply suggestion from @JamesNK * Update timestamp example dates to use 2026 --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> Co-authored-by: James Newton-King <james@newtonking.com>
* Fix persistent container endpoint proxy default docs Persistent containers use proxied endpoints by default (same as session containers), while persistent executables and projects default to proxyless endpoints. Also document that proxyless container endpoints with only a targetPort immediately allocate the targetPort as the host port. Corrects docs that previously stated all persistent resources default to proxyless endpoints. Documents changes from microsoft/aspire#17960. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Negstad <50252651+danegsta@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…re#17889) (#1210) * docs: update Foundry Local section to reflect CLI-based lifecycle The Foundry Local integration now uses the installed 'foundry' CLI (foundry service start/stop/list and foundry model download/load) instead of the FoundryLocalManager in-proc APIs. Aspire manages the entire service lifecycle automatically. Update docs to: - Clarify users do not need to pre-start Foundry Local - State that the 'foundry' CLI must be on PATH - Describe the automatic start/stop lifecycle management Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Sébastien Ros <sebastienros@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Aspire 13.5 “What’s new” placeholder content and updates several docs to reflect recent networking/persistence behavior changes and new CLI telemetry search capabilities (timestamp filtering).
Changes:
- Add placeholder release notes page for Aspire 13.5 and wire it into the docs sidebar.
- Update persistent lifetime/proxyless endpoint guidance across “What’s new”, networking fundamentals, and resource lifetime docs.
- Extend CLI
--searchdocumentation to include timestamp comparisons for logs/traces/spans (plus command reference updates).
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| src/frontend/src/content/docs/whats-new/aspire-13-5.mdx | Adds placeholder Aspire 13.5 release notes + upgrade/install guidance scaffolding. |
| src/frontend/src/content/docs/whats-new/aspire-13-4.mdx | Clarifies persistent proxy behavior differences between containers vs executables/projects. |
| src/frontend/src/content/docs/reference/cli/search-filter.mdx | Documents timestamp qualifier and comparison behavior for --search. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-otel-traces.mdx | Updates supported search fields + adds timestamp filtering example. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-otel-spans.mdx | Updates supported search fields + adds timestamp filtering example. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-otel-logs.mdx | Updates supported search fields + adds timestamp filtering example. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx | Updates Foundry Local lifecycle explanation and prerequisites around foundry CLI. |
| src/frontend/src/content/docs/fundamentals/networking-overview.mdx | Refines proxyless endpoint defaults/behavior for persistent resources and containers. |
| src/frontend/src/content/docs/app-host/resource-lifetimes.mdx | Updates persistent lifetime endpoint proxy defaults and proxyless container endpoint note. |
| src/frontend/config/sidebar/docs.topics.ts | Adds “Aspire 13.5” entry to the “What’s new” sidebar section. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Contributor
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Add a new row to the CLI telemetry data points table for Aspire CLI 13.5 documenting the new coding agent detection telemetry. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…8065-a0f9d35c8766b2f3 [docs] Document coding agent telemetry detection in CLI telemetry page
* docs: add WithTerminal() interactive terminal sessions page Documents the WithTerminal() experimental API introduced in Aspire 13.5: - Basic usage (C# and TypeScript) - Custom terminal dimensions - Multi-replica support - Dashboard terminal view - aspire terminal attach / aspire terminal ps CLI commands Closes microsoft/aspire#17866 (docs obligation) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: address PR review feedback for withterminal docs - remove redundant sidebar translations block - clean up unused import and wording updates - fix CLI reference link target - remove duplicate build/run call in dimensions sample Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Mitch Denny <midenn@orangecake.local> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Update all banners (18 files across English and 16 locale variants) from 13.4 to 13.5 with engaging messaging - Replace 13.5 placeholder release notes with comprehensive content from the official changelog - Include detailed release highlights covering AppHost, CLI, Dashboard, and Extensions improvements - Document breaking changes (ServiceProvider renamed, PublishAsConnectionString obsolete, aspire ps --resources flag removed) - Maintain consistent tone and voice with prior What's new articles Changes cover: - Interactive terminal sessions with WithTerminal() - Polyglot IInteractionService across TypeScript, Python, Go, Java, Rust - User-defined resource command arguments - TypeScript AppHost stability fixes and optimizations - Custom health checks for TypeScript AppHosts - CLI enhancements (npm package, embedded skills bundle) - Dashboard telemetry improvements (timestamp filtering, better error messages) - VS Code extension enhancements (Dashboard side panel, Bun debugging, resource commands) - Foundry Local integration CLI updates - And more bug fixes and improvements Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add documentation for the new operating system check introduced in microsoft/aspire#18252. The check appears in the Environment section of `aspire doctor` output and includes structured metadata in JSON format. Changes: - Update Environment checks description to mention OS reporting - Add OS check to sample table output - Add operating-system entry to JSON output example - Document the osType/displayName/version/description metadata fields Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Add Kubernetes persistent volume documentation
Document the first-class KubernetesPersistentVolumeResource feature
(microsoft/aspire PR #16929): a dedicated Persistent volumes on
Kubernetes page under deployment/kubernetes, a concise pointer in the
Kubernetes integration reference, sidebar wiring, and cross-links from
related Kubernetes and data-persistence pages.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
* Lead persistent volumes page with AddPersistentVolume API
Refocus the opening on the AddPersistentVolume fluent API with a minimal
example up front, rather than the KubernetesPersistentVolumeResource class
name, matching how developers think in terms of AppHost APIs.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
* Fix TypeScript persistent-volume examples and parameter method names
- Correct withDataVolume TS calls to pass an options object
(withDataVolume({ name: 'pg-data' })) instead of a name string; the
TypeScript binding takes WithDataVolumeOptions, not a string.
- Clarify the config-method table: in TypeScript the parameter-accepting
variants are separate methods (withPvStorageClassParam,
withPvCapacityParam, withVolumeAnnotationParam), not overloads of the
string methods.
Verified against the shipped Aspire 13.5.0-preview.1 package by compiling
and publishing both examples with the dev CLI.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---------
Co-authored-by: Mitch Denny <midenn@orangecake.local>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Mitch Denny <midenn@Mac.localdomain>
* Add WithTerminal docs and aspire terminal CLI reference Document the experimental WithTerminal() AppHost API for exposing interactive terminal sessions on resources, plus the aspire terminal, aspire terminal attach, and aspire terminal ps CLI commands. Wires the new pages into the docs and reference sidebars and repoints the 13.5 what's-new link to the new slug. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Frame no-auto-debugger as a temporary NOTE callout Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Give C# and TypeScript equal billing in with-terminal docs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Consolidate WithTerminal docs onto with-terminal.mdx Remove the duplicate withterminal.mdx (from #1244) in favor of the kebab-case with-terminal.mdx, matching the app-host directory naming convention. Fold in the dashboard section and the TypeScript config tracking issue reference. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address PR review: self-contained snippets and ASPIRETERMINAL001 guidance Add the #pragma warning disable ASPIRETERMINAL001 suppression to the C# examples, make the Experimental aside actionable, and make the configure and replicas snippets self-contained (full builder bootstrap + run) for both C# and TypeScript. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Mitch Denny <midenn@Mac.localdomain> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
alistairmatthews
approved these changes
Jul 6, 2026
alistairmatthews
left a comment
alistairmatthews
left a comment
Contributor
There was a problem hiding this comment.
Please address my comments, then this is good to go.
* Document AI agent skill usage telemetry in CLI telemetry reference Extend the Microsoft-collected CLI telemetry page to cover the agent telemetry hooks installed by 'aspire agent init': the three event types (skill_invocation, tool_invocation, reference_file_read), the exact low-cardinality fields recorded, the privacy guarantees (only Aspire-owned skill/tool names and skill-relative reference paths; never absolute paths, repo or user names, file contents, or tool arguments), and the ASPIRE_CLI_AGENT_TELEMETRY_OPTOUT / --no-telemetry-hooks opt-out paths. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Simplify CLI telemetry docs to a single opt-out Remove the AI-only opt-out section (ASPIRE_CLI_AGENT_TELEMETRY_OPTOUT) and the 'aspire agent init --no-telemetry-hooks' note. The single ASPIRE_CLI_TELEMETRY_OPTOUT switch disables all CLI telemetry including AI agent skill usage. Soften the over-claimed opt-out re-check wording. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Alistair Matthews <alistairwebdojo@live.com> --------- Co-authored-by: David Pine <7679720+IEvangelist@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Alistair Matthews <alistairwebdojo@live.com>
…ds (#1348) Add documentation for the --skills and --skill-locations options on aspire init and aspire new commands. These flags were added in microsoft/aspire#18191 and microsoft/aspire#18192 to support non-interactive mode for controlling which agent skills are installed during initialization.
…action service (#1347) - Add PromptProgressAsync to the interaction service docs with C# and TypeScript examples - Add CommandProgressOptions section to custom resource commands page - Integrate TypeScript tabs throughout interaction service documentation - Update method table and context notes to include PromptProgressAsync Documents changes from microsoft/aspire#18493
…1353) * docs: mention 'Stopping Aspire...' feedback message on Ctrl+C * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: David Pine <IEvangelist@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
… shutdown (#1356) Co-authored-by: David Pine <IEvangelist@users.noreply.github.com>
…aScript support (#1354) * docs: update Bun integration page for first-party Aspire.Hosting.JavaScript support * Apply suggestion from @IEvangelist * Update bun-apps.mdx --------- Co-authored-by: David Pine <IEvangelist@users.noreply.github.com>
- search-filter: fix 'stored with UTC' -> 'stored in UTC' - configuration: move AppHost type into code-block titles, drop redundant labels - with-terminal: reword title/seoTitle to 'using WithTerminal', scope experimental Aside to C#, move C#/TypeScript notes inside their TabItems, split dashboard sentence - troubleshooting: clarify firewall/security software wording - persistent-volumes: move experimental Aside into C# TabItem, add prerequisites intro, split StatefulSet sentence - compute/kubernetes: clarify durable storage steps - terminal command docs: 'using WithTerminal' wording and reworded descriptions Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: d03541af-fa62-4d7c-a158-4ece169249af
…ppHosts (#1355) * docs: document automatic HTTPS certificate generation for non-.NET AppHosts Documents the new behavior introduced in microsoft/aspire#17454: - When aspire run starts a non-.NET AppHost (e.g., TypeScript) in non-interactive mode and no HTTPS dev certificate exists, the CLI now automatically generates one. - The ASPIRE_CLI_GENERATE_HTTPS_CERTIFICATE environment variable can be set to 'false' to opt out of automatic certificate generation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update src/frontend/src/content/docs/app-host/certificate-configuration.mdx --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Dcument Go polyglot options flattening breaking change * Update documentation on DTOs and code generator behavior Clarified the behavior of TypeScript and Go code generators regarding optional parameters and DTOs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.